---
title: "Accessibility Checker Rule Help: aria_semantics_attribute"
---
import "../../../styles/ToolHelp.scss"
import { CodeSnippet, Tag } from "carbon-components-react";

<div className="toolHelp">
<Row>
<Column colLg={16} colMd={8} colSm={4} className="toolHead">

### The WAI-ARIA attribute `{0}` is not valid for the element `<{1}>` with WAI-ARIA role `{2}`

<div id="locLevel"></div>

WAI-ARIA attributes must be valid for the element and WAI-ARIA role to which they are assigned

</Column>
</Row>
<Row>
<Column colLg={11} colMd={5} colSm={4} className="toolMain">

### Why is this important?

Some HTML elements or attributes have native semantics that map, by default, to implied WAI-ARIA semantics. For predictable interaction and behavior of UI controls, these implicit semantics should only be overridden as defined in the [W3C ARIA in HTML Document conformance requirements for use of ARIA attributes in HTML](https://www.w3.org/TR/html-aria/#docconformance) specification.

<div id="locSnippet"></div>

### What to do

* If a native HTML attribute fits the intended behavior, use that instead of adding ARIA markup;
* OR, update the attributes on the element using the guidance in the [Document conformance requirements for use of "ARIA" attributes in HTML](https://www.w3.org/TR/html-aria/#docconformance) section of the W3C ARIA in HTML specification. This reference provides details of valid ARIA markup on native HTML elements.

</Column>
<Column colLg={5} colMd={3} colSm={4} className="toolLeft">

### About this requirement

[IBM 4.1.2 Name, Role, Value](https://www.ibm.com/able/requirements/requirements/#4_1_2)
[W3C ARIA in HTML Document conformance requirements for use of ARIA attributes in HTML](https://www.w3.org/TR/html-aria/#docconformance)

### Who does this affect?

* People using a screen reader, including blind, low vision and neurodivergent people

</Column>
</Row>
</div>

export default ({ children, _frontmatter }) => (<React.Fragment>{children}</React.Fragment>)
